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PREFACE 



This publication is intended for system 
programmers and IBM Field Engineering 
personnel. The reader should be famil- 
iar with the general machine functions 
of 370-XA, as described in the IBM 
370-XA Pri nci pies of Qperati on > 
SA22-7085, and with the MVS/SP Version 2 
Licensed Program* referred to in this 
publication as the MVS/XA control 
program. The standard names for MVS/XA 
control blocks are used throughout the 
publication. The formats of these 
control blocks are described in the 
MVS/XA Debugqi ng Handbook, Volumes 1 
through 5, LC28-1164 through LC28-1168, 
respectively. 
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Changes are periodically made to the information herein; before 
using this publication in connection with the operation of IBM 
equipment, refer to the latest IBM Svstem/370 and 4300 Processors 
Bi bl i ography , GC20-0001, for the editions that are applicable and 
current. 

References in this publication to IBM products, programs, or 
services do not imply that IBM intends to make these available in 
all countries in which IBM operates. Any reference to an IBM 
program product in this publication is not intended to state or 
imply that only IBM's program product may be used. Any func- 
tionally equivalent program may be used instead. 

Publications are not stocked at the address given below. 
Requests for IBM publications should be made to your IBM repre- 
sentative or to the IBM branch office serving your locality. 

A form for reader's comments is provided at the back of this 
publication. If the form has been removed, comments may be 
addressed to IBM Corporation* Product Publications, Department 
B98, PO Box 390, Poughkeepsi e, NY, U.S.A. 12602. IBM may use or 
distribute any of the information you supply in any way it 
believes appropriate without incurring any obligation whatever. 
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ASSISTS FOR MVS/XA 



This publication describes six 
instructions that depend on control 
blocks whose formats and relationships 
normally are established only by the 
MVS/XA control program. These 
instructions improve performance in 
frequently used parts^of the MVS/XA 
control program on machines which 
provide the 370-XA architectural mode 
and these instructions. Four of the 
instructions assist the handling of 
control-program locks. A locking proto- 
col is used by the MVS/XA control 
program to achieve serial use of 
control-program resources! when multipro- 
gramming and multiprocessing activities 
may cause temporary, multiple demands 
for the same resource. One instruction 
assists the execution of the SUPERVISOR 
CALL instruction, which is frequently 
used to request control-program 
services. The remaining instruction 
helps in establishing parameters that 
are used by the MVS/XA control program 
following detection of certain failure 
and error conditions. The six 
instructions are: 

ADD FRR 

OBTAIN CMS LOCK 
OBTAIN LOCAL LOCK 
RELEASE CMS LOCK 
RELEASE LOCAL LOCK 
SVC ASSIST 

All of the instructions are privileged 
i nstruct i ons. 

ADD FRR uses the RRE instruction format: 



Op Code 


//////// 


R, 


R 2 



16 



24 



28 31 



The other instructions use the SSE 
format. The SSE instruction format is: 



Op Code 



B, 



D, 
-/— 



"Q 



16 



20 



32 



36 47 



In addition to the operands explicitly 
designated by the instructions, implicit 
operands at fixed storage locations are 
also used. Sometimes operands fetched 
from storage are used in turn for 
addressing still other operands. Unless 
otherwise stated, all operand addresses 
are logical. Either 24 or 31 bits are 
used for addressing, depending on the 
value of the A-mode bit in the current 
PSW. The leftmost eight bits or the 
leftmost bit, depending on the A-mode 
bit in the current PSW, are ignored in a 
word which is a source of an operand 
address or a branch address. Storage 



protection applies to all storage opai — 
and accesses in the usual way. A 
specification exception is recognized 
for any operand that does not meet a 
specified alignment requirement, and 
instruction execution is suppressed. 
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Program-event recording applies in the 
usual fashion to these instructions, 
except that branch events are not recog- 
nized when these instructions cause 
branchi ng. 

The two instructions which obtain locks 
fetch and test a word for zeros, and, if 
the fetched word is zero, cause a speci- 
fied value to be stored back at the same 
location by means of an interlocked 
update. The two instructions which 
release locks may perform a conditional 
interlocked update of a doubleword 
location. For these instructions, if 
the second word of a doubleword location 
contains all zeros, the entire double- 
word is set to zeros by means of an 
interlocked update. When the SVC ASSIST 
instruction is used to assist a type-1 
SVC, a conditional interlocked update of 
a doubleword location is performed which 
is similar to that performed by the 
COMPARE DOUBLE AND SWAP instruction. 

The four lock-handling instructions may, 
under certain conditions, access the 
lock-interface-table prefix, consisting 
of the four words at negative offsets 
from the lock-interface table. The 
lock-interface table is located by using 
an address contained in the word in main 
storage following the second operand. 



SIMPLIFIED EXECUTION PATHS 



Simplified execution paths are defined 
for the following instructions. When a 
simplified path is used, specific 
actions defined for the corresponding 
instruction are performed uncondi- 
tionally? that is, specific actions are 
taken without the prescribed tests being 
made to determine that those actions 
should be selected. 



OBTAIN CMS 
proceeds as 
already held. 



LOCK , 
if a CMS 



Executi on 
lock were 



OBTAIN LOCAL LOCK . Execution 
proceeds as if the local lock Mere 
already held. 

RELEASE CMS LOCK . Execution 
proceeds as if the currently 
dispatched unit of work held no CMS 
lock. 

RELEASE LOCAL LOCK . Execution 
proceeds as if the local lock Mere 
already released. 

• SVC ASSIST ♦ Instruction execution 
is completed with normal instruc- 
tion sequencing and without the 
performance of other actions. 

Use of the simplified execution paths is 
not apparent to application programs 



using program products. In certain 
models, simplified execution paths are 
used when the available control-storage 
space is limited. The ADD FRR instruc- 
tion is optional and may or may not be 
provided as part of the assists. 



INSTRUCTIONS 



The instructions described in this 
section are listed in the figure 
"Instruction Summary," as are their 
operation codes and the program- 
interruption conditions that can be 
recognized when they are executed. 

In the format shown in the instruction 
description, the operation code is given 
in hex, which is signified by enclosing 
its value in single quotation marks 
( » XXXX ' ) . 



Name 


Characteri sti cs 


Code 


ADD FRR 

OBTAIN CMS LOCK 
OBTAIN LOCAL LOCK 
RELEASE CMS LOCK 
RELEASE LOCAL LOCK 
SVC ASSIST 


RRE 
SSE 
SSE 
SSE 
SSE 
SSE 


M 
M 
M 
M 
M 
M 


A 
A 
A 
A 
A 
A 


SP 
SP 
SP 
SP 
SP 
SP 


R OP 

R 

R 

R 

R 
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ST 
ST 
ST 
ST 
ST 
ST 


B242 
E506 
E504 
E507 
E505 
E503 


Explanati on: 


apti on 
arati on 

/ent 


event 








A Access exceptions 

M Privileged-operation exc< 

OP Operation exception 

R PER general-regi ster-alti 

RRE RRE instruction format 

SP Specification exception 

SSE SSE instruction format 

ST PER storage-alteration e> 



Instruction Summary 
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ADD FRR 



OBTAIN CMS LOCK 



CRRE] 



f B242 ? 


//////// 


R, 


R a 



16 



24 



28 31 



General Form 



^506' 



B, 



16 20 



D, 
-/— 



'S3 



32 36 



47 



A new entry is added to the top of the 
current functi onal- recovery- rout i ne 
(FRR) stack. The entry is initialized 
with values provided in general regis- 
ters, with the PSW A-mode bit (bit 32), 
and with the PSW S bit (bit 16). 
Optionally, the contents of control 
registers 3 and 4 are saved in an entry 
in a separate table. 

The general register designated by the 
R 2 field provides the logical address of 
the FRR entry point. 
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(3) the logical address 
tack-table entry. 
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Forms Used i n the Control Program 
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Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
8 are placed in general register 13, and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSW, leaving the A-mode bit 
unchanged. 



Serialization occurs 
fetched and, if the 
again after the lock 



before the lock is 
lock is obtained, 
is updated. 



Condi ti on Code: The 
unchanged. 

Program Excepti ons: 

Access 

Privileged operation 

Specif i cati on 



OBTAIN LOCAL LOCK 



code 



remai ns 
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Form Used i n the Control Program 
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If the local lock in the ASCB addressed 
by the first-operand word is not held, 
the lock is replaced, by using an inter- 
locked update, with the value from the 
word at the second-operand location 
minus 4; the local-lock bit of the word 
fetched from the second-operand location 
is set to one; and zeros are placed in 
general register 13. 

Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
16 are placed in general register 13, 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSW, leaving the A-mode 
bit unchanged. 

Serialization occurs before the local 
lock is fetched and, if the lock is 
obtained, again after the lock is 
updated. 



after the CMS lockword is zero, then the 
doubleword containing the lockword is 
set to zero by using an interlocked 
update. Also, the word fetched from the 
second-operand location is set to show 
that no CMS lock is held, and zeros are 
placed in general register 13. 

Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
4 are placed in general register 13; and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSW, leaving the A-mode bit 
unchanged. 
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Condi ti on Code: The 
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Program Excepti ons« 

Access 

Privileged operation 

Specif icati on 
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Forms Used in the Control Program 
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If (1) the contents of the CMS lockword 
addressed by general register 11 equal 
the contents of the first-operand word, 
(2) the currently dispatched unit of 
work holds a CMS lock, and (3) the word 
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Form Used in the Control Program 
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Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
12 are placed in general register 13, 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSW, leaving the A-mode 
bit unchanged. 
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Program Excepti ons? 

Access 

Privileged operation 

Speci f i cat i on 



SVC ASSIST 



General Form 
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Form Used i n the Control Program 
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The first and second operands are words 
containing the addresses of the current 
ASCB and TCB, respectively. 

Main-storage locations which contain 
status for the last SVC interruption are 
tested to determine if SVC-assi st action 
is to be taken. If SVC-assi st action is 
not taken^ instruction execution is 
completed with normal instruction 
sequencing. No assist action is taken 
unless the CPU was enabled prior to the 
last SVC i nterrupti on, and a task is 
currently dispatched which holds no 
locks and for which SVC screening is not 
activated. In addition, no assist 
action is taken unless (1) both the 
primary space and the secondary space 
match the dispatched space, and 
(2) primary-space mode is specified in 
the supervisoi — call old PSUI. 

A type-1 SVC request is assisted only if 
the request is for an assi stable type-1 
function, if the only lock needed for 
the requested SVC function is the local 
lock, and if an attempt to obtain the 
local lock is successful. 

A type-2, -3, or -4 SVC request is 
assisted only if the request is for an 
assistable function of type 2, 3, or 4, 
and if an attempt to dequeue an SVRB 
from the SVRB pool of the current 
address space is successful. 



A type-6 SVC request is assisted only if 
the request is for an assistable type-6 
function for which no locks are needed. 

Assist action consists in copying the 
information stored at the last SVC 
interruption into the current request 
block, saving all 16 general registers, 
loading the general registers as shown 
below, and then loading the instruction 
address portion of the PSW from general 
regi ster 9 . 



GR No. 
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11 

12 
14 



Contents Loaded 
on Assi st Acti on 

Address of CVT 

Second operand 

Address of the current RB for 
type 1 or type 6; address of 
the acquired SVRB for type 2, 
3, or 4 

SVC entry-point address 

First operand 

Address of the RB for the 
program which was being 
executed at SVC interruption 

Entry address from that MPL 
field which is appropriate to 
the SVC type, that is, the 
address of the routine that 
receives control on completion 
of the assi st 

Address of the MBCB part of 
the SVRB acquired; for type 2, 
3, or 4 only 

Address of requested SVC-table 
entry 

Exit address from that MPL 
field which is appropriate to 
the SVC type 
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